Obtener opción de fulfillment - Fire spark

{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE",
    "channel_ids": ["app", "web", "call-center"]
  }
}

Devuelve una opción de fulfillment para el comercio autenticado. Usa este endpoint cuando ya conoces el id externo y necesitas el nombre, código de tipo y estado actuales sin listar todas las opciones.

Requiere un access token con el scope fulfillment:read. Consulta Token para obtener un token.

Parámetros de ruta

Parámetro	Tipo	Descripción
`id`	string	Identificador externo de fulfillment. Solo caracteres alfanuméricos, `_` y `-`. 1–64 caracteres. Único por comercio.

Parámetros de consulta

Parámetro	Requerido	Descripción
`channel_id`	No	Identificador externo del canal. Si se indica, responde 404 salvo que `channel_ids` del fulfillment lo incluya.

Solicitud

Reemplaza {id} con el identificador externo de fulfillment.

curl "https://firespark.cloud/api/integrations/v1/fulfillment/delivery?channel_id=app" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Respuesta

La respuesta envuelve un objeto de fulfillment en data.

{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE",
    "channel_ids": ["app", "web", "call-center"]
  }
}

Objeto fulfillment

Campo	Tipo	Descripción
`id`	string	Identificador externo de fulfillment. Coincide con el parámetro de ruta.
`uid`	string (UUID)	Identificador interno de Fire spark.
`merchant_id`	string (UUID)	Comercio al que pertenece la opción de fulfillment.
`name`	string	Nombre para mostrar. 1–100 caracteres.
`type`	string	Código del tipo de fulfillment. 1–100 caracteres. Valores comunes: `DELIVERY`, `PICKUP`, `DINE_IN`. También se admiten códigos personalizados.
`status`	string	`ACTIVE` o `INACTIVE`.
`channel_ids`	string[]	Identificadores externos de canales donde este fulfillment está disponible. Vacío significa inaccesible en todos los canales.

Respuestas de error

Estado	Descripción
`401`	Access token ausente o inválido.
`403`	El token no incluye el scope `fulfillment:read`.
`404`	No existe una opción de fulfillment con el `id` indicado, o no está disponible para `channel_id`.